﻿EpubSTAR README
3.1.1
Copyright by Oxen (Huang Chun-Sheng), 2011-04-16 ~ 2014-06-02


1 INTRODUCTION

EpubSTAR is an epub and mobi format e-books generator, and now supports  "WORD to EPUB/MOBI" conversion, "TEXT to EPUB/MOBI" conversion and "Markdown to EPUB/MOBI" conversion. You can use EpubSTAR to convert your Word document (doc, docx), plain text (txt) or Markdown text(md, markdown, mdown, markd) into the EPUB and MOBI format eBooks automatically. Registration Edition supports image processing. Its characteristic is easy to learn, easy to operate, and one-click conversion. Just three steps, you can produce a sophisticated print quality eBooks. Ebook beginners could have an opportunity to experience the high quality eBook production.

Three Functions
˖WORD to EPUB/MOBI: Convert your Word document (doc, docx) into the EPUB/MOBI format eBooks. 
˖TEXT to EPUB/MOBI: Convert your plain text (txt) into the EPUB/MOBI format eBooks. 
˖Markdown to EPUB/MOBI: Convert your Markdown text (md, markdown, mdown, markd) into the EPUB/MOBI format eBooks. 

Two Formats
EpubSTAR can output two types of e-book format:
˖ EPUB eBook : EPUB2, EPUB3 and EPUB3 ( compatible with EPUB2) three versions of epub ebook.
˖ MOBI eBook : Kindle version 6 and version 8 (KF6, KF8) two versions of mobi books.

Multi languages support
Interface regional languages switch (English, German, Spain, Chinese traditional, Chinese Simplified). 
˖Multi-language text mixed processing.
˖Multi-language style mixed processing. 

Releases Web site
1. http://www.hi-pda.com/forum/viewthread.php?tid=765915
2. http://www.by-smart.com/forum.php?mod=viewthread&tid=2398
3. http://www.epubstar.com (to be opened)

Problems (bug) feedback
Problems (bug) feedback please post threads under. Or chat on QQ groups and on SINA micro-groups "eBook Garden":
˖EpubSTAR bug post: http://www.by-smart.com/forum.php?mod=viewthread&TID=2399
˖EBook Garden Taobao: 941068021 (verify password: Hi-PDA)
˖EBook Garden QQ Group 1: 192165732.
˖EBook Garden QQ Group 2: 105456363. May apply.
˖SINA micro-group "eBook Garden": http://q.weibo.com/608769 (password: Hi-PDA)


2 EDITIONS

˖Registration Edition (Reg): Style tag:can recognize tbody format, h1-h6, and 52 style other. Style expression forms: full contro. Oxen's Style, quick styles. Local style sheet import: numerous. Style advanced customization. Footnote dealing with infinite. Image processing: infinite. Cover custom. Setting saved. Contribution amount US$79.

Detailed versions feature differences, please refer to the "EpubSTAR Edition List. xls" and "EpubSTAR Style Recognition List. txt".

3 DONATIONS

EpubSTAR development is caused by accident, as well as amateur productions. If you are satisfied with my software and want to help me stay the best software, please donate as much as you can.Thanks!

˖Donation 1 (PayPal): http://www.by-smart.com/epubstar/donate_papal.html

˖Donation 2 (Taobao): http://item.Taobao.com/item.htm?ID=17325636221  (Taobao occasionally making a gaffe: "baby is off the shelf." When you have this problem, use donation 1 or 3 direct payment with PayPal or Alipay).

˖Donation 3 (Alipay): https://me.alipay.com/epubstar

Donor Registration Edition, use the following process:

1) Download and run the program, fill out and send registration information. Click Menu bar "help-register/upgrade" (or "help-about-register/upgrade"), select or fill out the registration information in the register /upgrade window. And then click the "Save" button to save the registration information file and sent to the EpubSTAR@tom.com mailbox.

2) I will return registration file to your email after processing.

3) Import registry file. You then open the register/upgrade window, click "import" button to import the registration file received. After restart the program, registration is successful.


4 UPDATE

[EpubSTAR 3.1.1.40518] 2014-05-18 Update:
1. Add Word-to-EPUB/MOBI's function of text box floating recognition processing.
2. Add Word-to-EPUB/MOBI's function of "TextBoxtitle" style recognition processing.
3. Add Marddown-to-EPUB/MOBI's function of underline emphasis recognition processing. So far, all emphasis mark such as asterisk ( * ) and underline ( _ ) could be recognized.
4. Add Marddown-to-EPUB/MOBI's function of inline code ( ` ) recognition processing in free version of EpubSTAR.
5. Fixes failure bugs of Word-to-EPUB/MOBI's functions of links, lists and text boxes recognition processing in EpubSTAR 3.1.0.
6. Increase fault tolerance , to avoid problems of links recognition processing in word document.
7 . Increase fault tolerance , to avoid problems of including spaces before and after source document file name .
8 . Increase fault tolerance , to avoid problems of only containing the ultra-small image  in word document.
Earlier Downloads : 110,022 .

[Oxen Style 6.1.1 ]( Oxen Classic Style ) 2014-05-18 Updated :
1. Add style definitions of floating around.
2. Optimize the title page title font size.

[EpubSTAR Quick Style 3.1.1 ] ( Oxen Minimalist Style ) 2014-05-18 Updated :
1. Add style definitions of floating around.

[EpubSTAR 3.1.1.40602] 2014-06-02 Update:
1. Fixed an array out of bounds issue with image processing.
Download: 110,904.


5 DOWNLOAD

5.1 EpubSTAR: 
Link1：http://www.by-smart.com/forum.php?mod=viewthread&tid=2398
Link2：http://www.by-smart.com/epubstar/download.html

5.2 Versions feature description: "EpubSTAR Editions Feature List" and "EpubSTAR Style Recognition List". 
Link1: http://www.by-smart.com/forum.php?mod=attachment&aid=MTIwMXw5N2I2NGRjZnwxMzM3MDAyMTE0fDJ8MjM5OA%3D%3D 
Link2: http://www.by-smart.com/epubstar/function.html

5.3 User's Guide: http://www.by-smart.com/forum.php?mod=attachment&aid=ODE1fGUzZTkxNjM3fDEzMjkzODIzODd8MnwyMzk4

5.4 Word templates: http://www.by-smart.com/forum.php?mod=attachment&aid=ODE2fDBiMjk3MGEyfDEzMjkzODIzODd8MnwyMzk4

5.5 Tutorial: http://www.by-smart.com/forum.php?mod=redirect&goto=findpost&ptid=2398&PID=4597

5.6 Word to EPUB Tutorial: "Word to EPUB：Easily Create Epub Ebooks". 
Link1: http://www.by-smart.com/forum.php?mod=viewthread&tid=2441
Link2: http://www.by-smart.com/eread/eread_8.html

5.7 Text to EPUB Tutorial: "From fool to Master: How to Use txt Create EPUB ebook". 
Link: http://www.hi-pda.com/forum/viewthread.php?tid=948974


6 INSTALLATION

6.1 Installer is setup.exe. Run the file to install EpubSTAR in a Windows environment. EpubSTAR required .NET Framework version 4. Setup.exe automatically detects .NET 4. If your computer is not installed .net4.0, the Setup program will automatically install from the Microsoft website to download.

Click here to download the .net4.0: http://www.microsoft.com/downloads/zh-cn/details.aspx?FamilyID=0A391ABD-25C1-4FC0-919F-B21F31AB88B7

6.2 EpubSTAR runtime environment is Windows XP or Windows 7/8(x86/64). If you want to use the feature of "WORD to EPUB", Word 2003 or higher version is also required. Note that "Compact Word" does not work correctly, please install the full version of the Word.

6.3 Security statement: There are feedback said when installing or running EpubSTAR, some security software propose to delete because of Trojan horse. Oxen hereby declares that my program does not do business such as Trojans and viruses. This security software false positives, please set EpubSTAR as an exception at its option, or temporarily close the related security software. At run time, because EpubSTAR need to download data such as Oxen's styles, false positive will be some strict security procedures. Make known.

7 IMPORTANT

7.1 Heading styles. To correctly generate an EPUB book, you should use defined word document specification before you get start. In a Word document, the title paragraph must be set as the heading styles, so "heading 1", "heading 2", "heading 3", etc. Only there is "heading 1", "heading 2" two one of the heading styles in Word document, EpubSTAR can split sections and pick up TOC text. Otherwise, it's impossible to treat chapter segmentation and TOC building.

Meanwhile, the first line of your Word document must be set to the corresponding heading styles. Especially not missing "heading 1", "heading 2", which is the most basic style for split chapters.

7.2 Copy-and-paste. During the split Word document, do not use windows copy and paste function, so as not to affect the split document content. Other time is not limited.

7.3 Cover page and Contents. EpubSTAR can automatically generate the cover and directories. So do not create cover and contents page in a word document, so as not to generate duplicate content.

7.4 Word document. For the avoidance of unexpected complexity of the problem, recommend to create and edit Word document with EpubSTAR's Word template as far as possible, or to use simple styles and formats as much as possible.

7.5 Text documents. Suggest you the best possible editing document structure into "Volume (Chapter, Section) **", or use "#", "##" tags mark the title paragraphs.

7.6 Image processing. Temporary support only jpg format, other formats are not supported. Supports only inline pictures in a paragraph, does not support floating (surrounded) pictures. Frames are not supported.

7.7 Get started. Please look at the TEXT to EPUB and WORD to EPUB tutorial, you can more easily get started and use.

8 OTHERS

8.1 If EpubSTAR report Word document error, please exit EpubSTAR, and in the windows task manager manually kill all named "winword" process then restart EpubSTAR. To avoid these problems, please install the full version of Word instead of the unofficial "Compact" Word. Please use the word document following above specifications to make the epub ebook. Word template provided by EpubSTAR are recommended to edit the Word document.

8.2 Problems encountered in the use, please contact me, so as to eliminate the bugs, improve program.

8.3 Contact website: http://www.by-smart.com; http://www.epubstar.com(to be opened).

